home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbsdoors
/
doormt10.zip
/
DOORMAT.DOC
< prev
next >
Wrap
Text File
|
1993-05-20
|
14KB
|
367 lines
+----------------------------------------------+
| Doormat, (C) Copyright 1991-93 Scott Johnson |
| for Jibben Software |
| Version 1.00 |
+----------------------------------------------+
This is a list of the files that should accompany this software
package:
README - Read me file with info to run Doormat locally.
ATTRACT.ANS - ANSI DOORMAT test file - Jibben Software Attraction
DM.BAT - Batch file for running Doormat locally as a test
DOORMAT.DEF - Example Doormat Configuration File.
FILE_ID.DIZ - BBS Description File.
DOORMAT.DOC - Doormat Documentation.
ORDERFRM.DOC - The order form.
DOORMAT.EXE - Doormat executable.
CATALOG.JSW - Information on current Jibben Software Products.
NAMES.LST - Sample name exclude/include list
DOOR.SYS - Dummy DOOR.SYS file for running Doormat locally.
AVEXTRA.TXT - Information regarding PKZIP AV codes.
ATTRACT.TXT - Text DOORMAT test file - Jibben Software Attraction
This software should not include any other files other than the ones
listed above. It was also compressed using either the PKZIP AV.
Shareware Trade Association & Resources
Scott Johnson is a charter member of STAR! STAR is the shareware
industries fastest growing trade association.
To obtain other fine software from members of STAR, please contact the
Software Creations BBS. It is the hub of the STAR distribution network
supporting 53 phone lines. To access Software Creations, you may call
the following numbers:
(508) 365-2359 - 2400 baud
(508) 368-4137 - US Robotics HST
(508) 368-7423 - Dual Standard, V.32bis
Please contact The Warehouse BBS for TECHNICAL SUPPORT at:
(612) 379-8272 - Dual Standard, V.32bis (10 phone lines)
The concept of Shareware
Doormat is being released as a Shareware product. Shareware is a
marketing concept, in which you get to try out a software package for
a period of time. If you find that the software is useful to you (you
are still using it), you are obligated to send in a registration fee
for that software to the author.
Doormat trial period is 21 days. That means, once you start using
Doormat, you have 21 days to decide whether or not it is useful to you.
If it is useful, please promptly send in the requested registration fee.
If it is not useful, you are expected to delete it and stop using it.
The shareware version of Doormat is functional. However, it will post
this annoying message to the user and pause until it is registered:
-Doormat- By Scott Johnson (C) 1993 Jibben Software, All rights reserved.
UNREGISTERED VERSION
Please register this software after 21 days or remove from the system.
Also, the timing functions will not be available until this version is
registered and there will be a 'press a key' message before the text is
displayed.
Here's what you get when you register (Please use ORDERFRM.DOC to order
this software):
1. Support. You can call and leave e-mail to me on the BBS listed in
the Technical Support section of this document I will more than
likely answer all questions, but the registered individuals will
definitely get top priority. You will also receive unlimited
telephone support for the program. Registered users will get a
phone number that they will be able to use to receive support between
the hours of 6:00 pm - 9:00 pm (Central Standard Time) Monday-Friday.
2. You will receive a disk with the most recent version of Doormat.
The software will also have all of the registration incentives
removed. The name and serial number of your BBS will also be
displayed in the main menu when the software is run.
3. Special access to new products. You will be allowed access to
beta test any software package that I'm in the process of creating.
The beta software will be available only on the Warehouse BBS.
Also you must make arrangements with Jibben Software to get access
to the new software. (see Technical Support section of this
document for details).
4. You will be able to download and upgrade your registered version
with the shareware releases of minor revisions (1.01, 1.10,
1.90...).
5. You will also have low cost upgrades for major revisions (2.0,
3.0...) of this software.
What is Doormat?
Doormat is geared for Sysops wanting a little more control in between
doors. Have you ever wanted to lockout certain user from a door? Block
out certain age groups? Display a message to all users before they
enter a door? Shut a door down during a certain time to run
maintenance or leave the board open for other uses? Have only a
certain group of people to access a certain door? Then this program
was written just for you.
Where did the idea come from?
On a board that I help run the SysOp posed a certain question, "How can
I display a message to all users letting them know of an external
interface that is available to download or to let the users know that I
am going to reset the game? How can I close the door down so I insure
clean data while the maintenance is running?" So the first generation
of Doormat was created. From there I received several other tips from
people that wanted to lock out all users under 18 for adult only type
doors, and another person that wanted to lock out certain troublesome
users from a storyboard that was ruined several times. So I set to
work on the whole picture, and came up with the final version and here
it is. I'm open to all comments or questions so if you have anymore
ideas, let me know.
Requirements for Doormat
Doormat should have at least 100KB of free memory to run.
Supported BBS Systems
---------------------
Doormat will support any BBS that creates a DOOR.SYS file when chaining
to a door. Also, Wildcat 2.x (CALLINFO.BBS), DORINFOx.DEF and
PC Board - 12.x through 14.x (PCBOARD.SYS) are supported.
Installation Instructions
Sample Door Batch File
----------------------
The door filename is placed on the command line of DOORMAT.EXE. Here is a
sample batch file calling Doormat before entering Jibben Software's
Galactic Overload door game. This example assumes the following:
Doormat.EXE is in the DOS PATH or in the door directory
DOOR.SYS and Doormat.DEF is in the door directory
C: ( change drives )
CD\DOORS\GO ( change to door directory )
Doormat DOOR.SYS Doormat.DEF ( run Doormat )
IF NOT ERRORLEVEL 0 GOTO END ( * )
GO DOOR.SYS ( run Jibben Software's Galactic Overlord )
:END ( END header for escaping batch file if error
CD\ ( change back to the root directory )
( * ) This line checks to see if an error occurs and exits the batch file
without entering the main door. (READ THE NOTE BELOW FOR MORE INFO)
A list of errorlevel codes follow:
Errorlevel -1 Fatal error; caller hung up, files missing, etc...
Errorlevel 0 No problems; ok to run next door
Errorlevel 1 User hit door closed times - registered version only
Errorlevel 2 User is under age
Errorlevel 3 User was on the exclude list
Non-Standard Comm Ports
-----------------------
If you have a DigiBoard system or are using Fossil drivers you can
still use this door game! You will have to add another parameter to
the door batch file. The format of this next parameter is PORT:AAAA:X.
*** NOTE: ***
The dos batch errorlevels, from testing and working with them, seem to
not allow the "NOT ERRORLEVEL 0". You may try this, HOWEVER, if this
does not work then replace the line "IF NOT ERRORLEVEL 0 GOTO END" with
the following lines:
IF ERRORLEVEL 3 GOTO END
IF ERRORLEVEL 2 GOTO END
IF ERRORLEVEL 1 GOTO END
IF ERRORLEVEL -1 GOTO END
Doormat Examples
The following batch file would request a port using interrupt 4 at
address 03F8.
C:
CD\DOORS\GO
Doormat DOOR.SYS PORT:03F8:4 DOORMAT.DEF
IF NOT ERRORLEVEL 0 GOTO END
GO DOOR.SYS PORT:03F8:4
END:
CD\
The following batch file would request port #3 on a DigiBoard.
C:
CD\DOORS\GO
Doormat DOOR.SYS PORT:D:3 Doormat.DEF
IF NOT ERRORLEVEL 0 GOTO END
GO DOOR.SYS PORT:D:3
END:
CD\
The following batch file would request port #2 on a Fossil Driver.
C:
CD\DOORS\GO
Doormat DOOR.SYS PORT:F:2 Doormat.DEF
IF NOT ERRORLEVEL 0 GOTO END
GO DOOR.SYS PORT:F:2
END:
CD\
Local Mode
----------
The door can be tested in local mode, although, you'll have to use a
DOOR.SYS file that has a comm port of zero (COM0:). The following
files are included:
LOCAL.BAT
DOOR.SYS
Simply typing LOCAL with the above files in the same directory as the
other Doormat distribution files will start the door in local mode.
Miscellaneous Setup Issues
--------------------------
Doormat supports multi-node access! So, you can safely allow
more than one node to access the door at one time. To best way to
accomplish this is to place Doormat.EXE somewhere in the search path.
When registering, place the overlay file in the SAME directory as
the Doormat.EXE file. However, you will be responsible for keeping
each DOOR.SYS or related door file separate from other players files.
Configuration
Doormat has been written to be easily configured. Included with this
distribution software is a file named Doormat.DEF ( or whatever you wish
to call it). It is very similar to a Microsoft Windows *.INI file. It
contains a sample configuration for the utility. It also contains the
documentation for the settings and what the options mean. Please refer
to this file to see how to configure your copy of Doormat.
Doormat Technical Info
Files
-----
Doormat is the first door utility released by Jibben Software. And is
also the first program ever released by the author Scott Johnson.
The only files that Doormat requires are:
Doormat.DEF - Doormat configuration file.
Doormat.EXE - Doormat executable.
All other distribution files may be removed to conserve disk space.
Special Sysop Functions
On-Line Sysop Commands
----------------------
While a caller is on-line, the local sysop has several options:
FKey Description
------- --------------------------------------------
F3* Toggle printer on/off
F4* Toggle pagebell on/off
F5 Shell to DOS
F7* Toggle caller alarm on/off
F8 Return user to system
F9 Toggle display on/off
Alt-Key Description
------- --------------------------------------------
ALT-H Toggle between different status lines
ALT-N* Toggle sysop on next
ALT-X* Toggle exit to dos after call and help lines
Alternately pressing the ALT-H key will bring up the next status line
screen. The 1st screen is a help screen, the second screen shows your
COM port status.
*The function keys marked with an "*" will only be of use to systems
using pcboard.sys. The rest are functional with any system.
Why cripple software?
A common practice for Shareware authors has been appearing, software
crippling. This unfortunate occurrence is needed to insure the
author's time and effort is compensated for. Please understand how
much time and effort goes into each program that is written.
Development Data
Doormat was written entirely in C++ using Borland C++ 3.1.
Technical Support
For technical support I (Scott Johnson) can be reached at the following
on-line systems:
The Warehouse BBS: 612-379-8272 1200-57600 baud V.32bis/HST 16.8K
(N81) - 10 Lines. The Warehouse is my first (main) line of support.
Since I am a co-sysop of this BBS, I usually log on several times a day
to check for email. This BBS is a subscription BBS, however anyone
logging on will receive access rights to the file area where my
software can be downloaded for FREE and a message area that is
dedicated to Jibben Software.
Door-Util conference from FIDO. I will be reading all messages sent to
me in this forum, but will respond as time permits. Of course,
registered users will get a response right away.
Acknowledgments
I would like to thank those people that have assisted me in the
development of this software:
Scott Jibben, a darn good programmer and friend who gave me Jibben libraries
to simplify and speed up development of this project and others to come...
Travis Carter, SysOp of the Warehouse BBS, for testing the software and
providing a message forum for supporting software written by Jibben Software.
My wife, for being patient and supportive in getting this software written
and out.
Finally, all of the people who've registered my software. I really
appreciate it!
Disclaimers, etc.
Jibben Software specifically disclaims all other warranties, expressed
or implied, including but not limited to implied warranties of
merchantability and fitness for a particular purpose, functionality or
data integrity. In no event shall Jibben Software be liable for any
loss of profit or any other commercial damage, including but not
limited to special, incidental, consequential or other damages.
Borland is a registered trademark of Borland International, Inc.
DigiBoard is copyright (c) DigiBoard.
Microsoft Windows is a registered trademark of Microsoft Corporation.